home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / misc / wt276.lzx / worktime.txt < prev   
Text File  |  2012-10-29  |  7KB  |  194 lines
  1.  
  2. Worktime
  3.  
  4. Description of functionality and inner parts.
  5.  
  6.  
  7.  
  8.  
  9. File and Record structure.
  10. --------------------------
  11.  
  12. A Worktime data file (.WT) consists of a number of records, all
  13. in this format:
  14.  
  15. Begin time       (a.begin&)    Time when the work/project started
  16. End time         (a.end&)      Time when the work/project ended
  17. Normal time      (a.norm&)     The expected worktime for this timeslot.
  18.                                This value is subtracted from the difference
  19.                                between Begin and End time.
  20.                                (Projects default to 0)
  21. Project text     (a.text$)     A Project text description
  22. Total time       (a.total&)    Accumulated time
  23.  
  24.  
  25. The above record fields have different meanings for different parts of
  26. the worktime data file. The a.begin& value is used to seperate between
  27. different sections of the file (Records are always kept in sorted order
  28. after a.begin&). The following sections are used:
  29.  
  30.  a.begin&
  31.  
  32.    0         Old setup record. Now unused.
  33.    1-99      Setup record. At the moment only 1-10 are used.
  34.  101-999     Projects (Project number+100).
  35.              This limits the number of project to 899 (999-100)
  36. 1000-        Time entries. a.begin& is number of seconds since
  37.              1/1/1970
  38.  
  39. Description of the field values for each section follows
  40.  
  41.  0- 99   TSetup&(),PSetup&(),Setup$() values [internal]
  42.  
  43.     0    Old setup, now unused
  44.  
  45.          TSetup&(): - Time mode
  46.     1-7  a.end&=Normal hours
  47.     8-9  a.end&=morning/evening slack
  48.     10   a.end&=Font
  49.  
  50.          PSetup&(): - Project mode
  51.     1-2  a.norm&=Project rounding single
  52.     3-4  a.norm&=Project rounding totals
  53.     5    a.norm&=Automatic project calculation
  54.     6    a.norm&=Normaltime disabled
  55.     10   a.norm&=Font
  56.  
  57.          Setup$():
  58.     1    a.text$=Print output file
  59.     2    a.text$="LOC::M:\*.WTM"
  60.     3-10 a.text$=Titles for printout (Not implemented)
  61.  
  62.          The next version of Worktime might change the meaning of the Print
  63.          information stored in the database.
  64.  
  65.  101-999 Projects / indexes
  66.  
  67.          a.begin&=100+Project number
  68.          a.end&=100 * cost/hour
  69.          a.text$=Project text
  70.          a.norm&=UNUSED
  71.          a.total&=Total time used
  72.  
  73.  1000-   Time slots
  74.  
  75.          a.begin&=Meeting time
  76.          a.end&=Leaving time
  77.          a.text$=Project/entry text
  78.          a.norm&=Normal (estimated) time
  79.          a.total&=Accum. time diff
  80.  
  81.  
  82.  
  83. Time mode
  84. =========
  85.  
  86. This mode gives a screen with the dates, Saturday/Sunday in grey,
  87. and for time entries the start time, end time, todays diff, accumulated
  88. total and project description.
  89.  
  90. Dates with no entries shows just the date. There is no limit to the number
  91. of entries per day. Internally there is no problem with entries spanning over
  92. one or more days, but care should be taken that when editing an entry
  93. (Psion-E or return) the ending date is set to the same date as the starting
  94. date.
  95.  
  96. The edit function can be entered by pressing any of Return, cursor left or
  97. Psion-E. The numbers shown in brackets are the unrounded time values.
  98. Cursor right edits just the comment field.
  99.  
  100. To move around between dates, use cursor up or cursor down.
  101. Use in combination with Shift (=4 entries), Psion (=10 entries) or control
  102. (=30 days) to move faster.
  103. The Jump to date moves directly to a date (Press Tab or Psion-J).
  104.  
  105. An entry can be copied (Psion-C) or Deleted (Delete or Psion-D) and later
  106. inserted (Psion-I). The Begin and End times are automatically modified to
  107. the inserted date. The Delete Range function (Shift-Psion-R) only saves the
  108. last entry deleted.
  109.  
  110. New timing slots can be started and ended by pressing the space bar.
  111. The Slack time definitions can be used to make it appear that you
  112. started the entry a pre defined time before pressing the space bar.
  113. The same applies for ending entries by pressing space bar
  114. (the slack time is just added instead).
  115.  
  116. If Normal Worktime is enabled (Pdion-N) the normal worktime of the day
  117. is automatically inserted into the record. Otherwise the normal is set
  118. to zero and therefore does not change the total shown.
  119.  
  120. The letters a-z can be used for user pre-defined Project starter keys.
  121.  
  122.   To defined a Project starter key, open the .OPL source code, and at the
  123.   end copy a 3 line function, change the function name (P=Project mode,
  124.   T=Time mode, A=Any mode) + a hexadecimal key number, and the project text.
  125.   Recompile the source code and you are ready to go.
  126.   You should probably keep a copy of your definitions in a separate file,
  127.   so it is easier to include when you get a new versin of Worktime.
  128.  
  129. If no project starter has been defined a Comment requester is shown. Type
  130. in the project text and the project will be started.
  131.  
  132. The program comes ready with the follwing predefined Project starter keys:
  133.  
  134.   l = Lunch
  135.   m = Meeting
  136.   w = Work
  137.  
  138. Project starter keys always sets the normal time to 0, and ignores slack
  139. time settings.
  140. Pressing a project starter key automatically ends a previous open project.
  141.  
  142. If you by accident ended a project that should not have been ended, you
  143. can edit the entry and modify the end time to 00:00:00, then the end time
  144. will be removed. (Use Psion-R to repaint the screen)
  145.  
  146.  
  147. The Usage (Psion-U) can be used to abtain a quick overview of the project
  148. usage for a period of time. 
  149.  
  150.  
  151.  
  152. Project Mode
  153. ------------
  154.  
  155. This is a new mode and still not fully implemented.
  156.  
  157. In project mode all of the projects are shown with a text, cost per hour,
  158. total time and total cost.
  159.  
  160. The sort function (Psion-S) clears total times (That functionality is bound
  161. to be removed in next version, because Tally now takes count of original
  162. totals for projects.)
  163.  
  164. The Tally function (Psion-T) recalculates the total time per project. If
  165. project does not already exist in project mode, the tally function adds it
  166. at end.
  167.  
  168. The Tab or Psion-J jumps to a specific project number.
  169.  
  170.  
  171.  
  172. Settings
  173. --------
  174.  
  175. Font Type, Zoom in/out (=Font size) settings are saved seperately for
  176. Project and Time mode.
  177.  
  178. Normal Worktime on/off, mon-sun only affects the space bar functionality.
  179.  
  180. Rounding affects all output, and the original time is only available
  181. in the edit windows or by setting rounding off. It is adviced to do a
  182. Sort (Psion-S) + Tally (Psion-T) after changing Rounding values.
  183.  
  184. Auto Calculation. I don't know what to say about this function. When having
  185. a small database it is usually nice to have. But just a hundred records
  186. or more and it becomes a stone around your legs.  My advice is to keep
  187. auto calculation off, and use Psion-T whenever you need the project totals
  188. to be updated.
  189.  
  190.  
  191.  
  192. Erik Johansen
  193. ej@it.dtu.dk
  194. 31/3/96